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BACKGROUND OF THE INVENTION 

1 . Field of Invention 

The present invention relates generally to methods, apparatus, and systems for 
manipulating data structures in a computing system. More particularly, the present 
invention relates to adding data on a circular, singly linked list. ^ 

2. Description of the Related Art 

Linked lists are well known in the art, and various methods have been 
employed to manipulate linked lists. Linked lists are one of the most common data 
structures employed for the manipulation of data. Linked lists are particularly 
important with an operating system. Operating systems control a variety of resources 
simultaneously. A linked list might be used, for example, to hold requests for each 
individual resource. Circular linked lists can also be used in a server-client 
environment where the server uses the circular linked list to record those clients that 
are waiting for service at a particular time. By using the circular linked list, a server 
can insure that its attention is evenly distributed amongst the waiting clients by 
visiting and servicing each waiting client as it circulates around the list. Using a 
consumer/producer model to visualize the linked list, the server can be considered the 
consumer and the clients each representing a producer as illustrated in Fig. 1 that 
shows a linked list 100 representing individual work queues (WQ). As shown in Fig. 
1, a producer adds work queues with new work to the list 100 as a consumer 
continually scans the list, processing packets from each work queue in turn and 
deletes a work queue when it's packets are spent. Using this arrangement, the list 100 
contains all work queues that are pending where they remain so long as they still have 
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work (or packets to transmit) until it is ultimately deleted when the work (or packet) 
has been depleted. 

Generally, linked lists can take two forms: (1) circular singly linked lists; or 
(2) circular doubly linked lists. With a singly linked list, each member contains a 
5 field pointing to the next member while doubly linked lists add a second pointer to 
each member that points to the previous member. Although doubly linked lists 
facilitate scanning in the reverse direction, they are more difficult to maintain since 
the additional pointers require additional write operations to SRAM substantially 
increasing cycle time over singly linked lists. 
10 Conventionally, additions to a linked list require at least 3 SRAM accesses an 

example of which is illustrated in Figs. 2A - 2C showing a conventional approach to 
adding a new member to a circular singly linked list 200 having a number of entries 
201. Assuming, for example, that an entry 201-3 is to be added between an entry 



|4 201-2 and an entry 201-4. As shown, the entry 201-2 has a next pointer field 202-2 

15 that points to the entry 201-4 which, in turn, has a next pointer field 202-4 which 



points to a next entry 201-1. During the conventional addition operation, (as shown 
in Fig. 2B) the contents of the next pointer field 202-2 are copied to a next pointer 



en 

f|j field 202-3 associated with the added entry 201-3 such that the entry 201-3 now 



points to the entry 201-4. Finally as shown in Fig. 2C, the next pointer field 202-2 
20 (associated with the entry 201-2) is updated such that the entry 201-2 points to the 
added entry 201-3 thereby completing the addition operation. Since accesses to the 
same SRAM can not generally be parallelized, it is important for performance reasons 
to keep the number of reads and writes to memory at a minimum. Although registers 
can be accessed in parallel they do not have the density of SRAM. 
25 Unfortunately, however, the conventional approach to adding entries to a 

circular singly linked list is wasteful of memory resources since the accesses to the 
SRAM cannot be parallelized using a single SRAM and adding additional SRAM 
resources is costly and inefficient. 

Therefore, what is desired is a method, apparatus, and system for efficiently 
30 adding a entry in an arbitrary (i.e., unspecified) location in a circular singly linked list. 
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SUMMARY OF THE INVENTION 

Methods and apparatus for augmenting a scan operation of a circular singly 
linked list by providing a method, apparatus, and system for adding a member of a 
5 circular singly linked list using a single SRAM write access is described. During a 
scan operation in a circular, singly linked list having a number of list entries each of 
which has an associated next pointer field and a root pointer register that includes a 
root pointer that points to, or otherwise references, an arbitrary list entry. In order to 
add a new list entry to the list, the root pointer included in the root pointer register is 
10 copied into a next pointer field of the added list entry. Next, the root pointer register 
is overwritten with a pointer that points to or otherwise references the added list entry. 
In this way, additions to a circular, singly linked list that are done at the time of 
2 scanning involve only a single SRAM write access. 

H- In a particular embodiment of the invention, the root pointer register points to 

01 

15 a most recently added list entry. 

In another embodiment, an apparatus for adding a current member of a 
jj3 circular, singly linked list is described requiring only a single memory write 

operation. 

In yet another embodiment, a computer program product for adding a current 
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^ 20 member of a circular, singly linked list is described 



These and other advantages of the present invention will become apparent 
upon reading the following detailed descriptions and studying the various figures of 
the drawings. 
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BRIEF DESCRIPTION OF THE DRAWINGS 



The invention may best be understood by reference to the following 
description taken in conjunction with the accompanying drawings. 

Figure 1 is a diagrammatic representation of a conventional circular singly 
linked list. 

Figs. 2A - 2C illustrate a conventional addition operation in a circular singly 
linked list. 

Figs. 3 A - 3C shows an exemplary circular, singly linked list in which a new 
member is added in accordance with an embodiment of the invention. 

Fig. 4 illustrates a flowchart describing a process for adding a member to a 
circular, singly linked list in accordance with an embodiment of the invention. 

Fig. 5 is a diagrammatic representation of a general-purpose computer system 
suitable for implementing the present invention. 
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DETAILED DESCRIPTION OF THE EMBODIMENTS 



Reference will now be made in detail to a preferred embodiment of the 
invention. An example of the preferred embodiment is illustrated in the 
accompanying drawings. While the invention will be described in conjunction with a 
preferred embodiment, it will be understood that it is not intended to limit the 
invention to one preferred embodiment. To the contrary, it is intended to cover 
alternatives, modifications, and equivalents as may be included within the spirit and 
scope of the invention as defined by the appended claims. 

During a scan operation in a circular, singly linked list having a number of list 
entries each of which has an associated next pointer field and a root pointer register 
that includes a root pointer that points to, or otherwise references, an arbitrary list 
entry. In order to add a new list entry to the circular, singly linked list, the root 
pointer included in the root pointer register is copied into a next pointer field 
associated with the added list entry. Next, the root pointer register is overwritten with 
a pointer that points to or otherwise references the added list entry. In this way, 
additions done at the time of scanning involve only a single SRAM write access. 

As currently described, the invention uses a root pointer register to facilitate 
additions to a circular singly linked list. Using the root pointer, linked list additions 
can be performed using a single SRAM access when the location of the added 
member is arbitrary. In the described embodiment, the root pointer points to, or 
otherwise references, an arbitrary location in the list for the site of the next addition. 
However, in order to make the list circular, the last member of the list has a link to the 
root pointer register. In a preferred embodiment, a NULL value is used as the next 
pointer of the last member. In so doing, a scan operation must recognize that the 
NULL value is a special marker indicating that in order to obtain the location of the 
next member of the list, the root pointer must be used when the NULL value is 
returned from a read of the list. 

The invention will now be described in terms of a circular, singly linked list 
where each member of the list includes both a content field for storing data as well as 
a next pointer field. It should be noted, however, that the invention is equally well 
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suited for applications where some, if not all of the members of the circular, singly 
linked list include only a next pointer field. 

It should be noted that a consumer scans a list by following a next pointer that 
is embedded in each member that points to a next member in the list and copying the 
5 next pointer into a current pointer register. The current pointer register is used as 
address as the next member is read. When the next member is read, its next pointer 
field is copied into the current pointer register and by repeating the process, every 
member in the circular, singly linked list can be scanned. 

Figs. 3A - 3C illustrates a system 300 for performing an exemplary addition 
10 operation in a circular singly linked list 301 in accordance with an embodiment of the 
invention. As shown in Fig. 3 A, the circular singly linked list 301 is formed of a 
JjJ number of work queues (WQ) 302, also referred to as members, each of which is 

5 formed of a content (or data) field 304 and a next pointer field 306. For example, the 

member 302-1 includes a content field 304-1 and an associated next pointer field 306- 
£0 15 1 that points to, or otherwise, references the next member of list 301, which in this 
7* case is the member 302-2, and so on. The system 300 also includes a current pointer 

^3 register 308 into which is stored a next pointer associated with a current member of 

fU the list 301. 

U'5 

p Using the consumer/producer paradigm as described above, each time the 

^ 20 consumer scans a current member on the list, the consumer copies the contents of the 
scanned member's next pointer field into the current pointer register and locates the 
next member of the list to be scanned using the content of current pointer register. 
Using the list 301 as an example, when the consumer scans the member 302-1, the 
consumer copies the contents of the next pointer field 306-1 (i.e., f 'nextptr 2 ") to the 
25 current pointer register 308 that is used, in turn, to locate the next member in the 
linked list 301 to be scanned, namely member 302-2, and so on. 

Associated with the list 301 is a root pointer register 310 having a root pointer 
312 that points to, or otherwise references, for this example, the member 302-4. As 
shown in Fig. 3B, in order to add a new member 302-3, for example, to the list 301, 
30 the root pointer 3 12 is copied to a next pointer field 306-3 associated with the new 

member 302-3. (It should be noted that this copy operation is the single SRAM write) 
In this way, the next pointer field 306-3 points to the member 302-4. Next, as shown 
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in Fig. 3C, the root pointer register 310 is updated such that the root pointer 312 
points to the new added member 302-3, which, in turn, points to the member 302-4. 

It should also be noted, that in this example, the relative positions of the 
various entries in the list 301 are irrelevant since any new entry can be added in an 
arbitrary location in the list 301. Therefore, the description above is for illustrative 
purposes only and should not be construed as limiting either the scope or intent of the 
invention. 

It should be noted that in a preferred embodiment of the invention, the root 
pointer register is essentially included as a member of the list which is accommodated 
by marking a last member of the list as a NULL member (by, for example, storing a 
NULL value therein) to indicate that the next member in the list is the member 
pointed to by the root pointer. Therefore, during a scan operation, when a consumer 
reaches the last member of the list and reads the NULL value, the consumer must use 
the root pointer to locate the next member of the list being scanned instead of the 
member's next pointer. It should also be noted that this does not require an additional 
SRAM access. 

Fig. 4 illustrates a flowchart describing a scan process 400 in accordance with 
an embodiment of the invention. The process 400 begins at 402 by determining if a 
root pointer is a NULL value. If the root pointer is not a NULL value, a next pointer 
is obtained at 404 by reading a current pointer. Next, if at 406 it is determined that 
the next pointer is not a NULL value, then at 408 the current pointer is set to the next 
pointer and the process 400 is done. If, however, the next pointer is determined to be 
the NULL value, then at 410 a determination is made if a root pointer is a NULL 
value. If the root pointer is determined to be the NULL value, then the list is empty 
and the current pointer is set to the NULL value at 412 and the process 400 is done. 
If, however, the root pointer is determined to not be the NULL value, then the current 
pointer is set to the value of the root pointer at 414. Returning to 402, it had been 
determined that the root pointer is a NULL value, then control is passed directly to 
410. 

Fig. 5 illustrates a typical, general-purpose computer system suitable for 
implementing the present invention. The computer system 1030 includes at least one 
processor 1032 (also referred to as a central processing unit, or CPU) that is coupled 
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to memory devices including primary storage devices 1036 (typically a read only 
memory, or ROM) and primary storage devices 1034 (typically a random access 
memory, or RAM). 

Computer system 1030 or, more specifically, CPUs 1032, may be arranged to 
support a virtual machine, as will be appreciated by those skilled in the art. As is well 
known in the art, ROM acts to transfer data and instructions uni-directionally to the 
CPUs 1032, while RAM is used typically to transfer data and instructions in a bi- 
directional mariner. CPUs 1032 may generally include any number of processors. 
Both primary storage devices 1034, 1036 may include any suitable computer-readable 
media. A secondary storage medium 1038, which is typically a mass memory device, 
is also coupled bi-directionally to CPUs 1032 and provides additional data storage 
capacity. The mass memory device 1038 is a computer-readable medium that may be 
used to store programs including computer code, data, and the like. Typically, mass 
memory device 1038 is a storage medium such as a hard disk or a tape which 
generally slower than primary storage devices 1034, 1036. Mass memory storage 
device 1038 may take the form of a magnetic or paper tape reader or some other well- 
known device. It will be appreciated that the information retained within the mass 
memory device 1038, may, in appropriate cases, be incorporated in standard fashion 
as part of RAM 1036 as virtual memory. A specific primary storage device 1034 
such as a CD-ROM may also pass data uni-directionally to the CPUs 1032. 

CPUs 1032 are also coupled to one or more input/output devices 1040 that 
may include, but are not limited to, devices such as video monitors, track balls, mice, 
keyboards, microphones, touch-sensitive displays, transducer card readers, magnetic 
or paper tape readers, tablets, styluses, voice or handwriting recognizers, or other 
well-known input devices such as, of course, other computers. Finally, CPUs 1032 
optionally may be coupled to a computer or telecommunications network, e.g., an 
internet network or an intranet network, using a network connection as shown 
generally at 1012. With such a network connection, it is contemplated that the CPUs 
1032 might receive information from the network, or might output information to the 
network in the course of performing the above-described method steps. Such 
information, which is often represented as a sequence of instructions to be executed 
using CPUs 1032, may be received from and outputted to the network, for example, 
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in the form of a computer data signal embodied in a carrier wave. The above- 
described devices and materials will be familiar to those of skill in the computer 
hardware and software arts. 

It should be noted that the present examples are to be considered as illustrative 
5 and not restrictive, and the invention is not to be limited to the details given herein, 
but may be modified within the scope of the appended claims. 
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